home *** CD-ROM | disk | FTP | other *** search
/ 45 Great Windows Utilities 6 / 45 Great Windows Utilities Volume 6 MOJO-405 (Mojo Software).iso / plant / plant.doc < prev    next >
Text File  |  1993-10-24  |  9KB  |  192 lines
  1.  
  2.                                   PLANT v1.30
  3.                   BMP, SCR, & WAV Swapping Utility for Windows
  4.  
  5.                         Copyright (c) 1993 Terry Matula
  6.                            Released October 24, 1993
  7.  
  8.  
  9.    Description
  10.    ===========
  11.    PLANT is a DOS application that will swap wallpaper, screen saver,  and/or
  12.    Windows system sounds.  All BMPs, SCRs, and WAVs are stored in  compressed
  13.    archives (PKZip format).   PLANT selects new files  directly from the  ar-
  14.    chives, decompresses them, gives them a standard name, and places them in
  15.    your Windows subdirectory.
  16.  
  17.    The name PLANT comes from the nature of  the swapping.  PLANT, as a  verb,
  18.    can mean 'To place for the purpose of deception.'  This is exactly the na-
  19.    ture of the swapping done by this program.  For example, Windows could  be
  20.    set to always use the wallpaper  file 'wpaper.bmp'.  PLANT  could then be
  21.    used to change 'wpaper.bmp'  from image to image.   This swapping is  com-
  22.    pletely invisible to Windows.
  23.  
  24.    As you may know, there are several other very similar programs that  basi-
  25.    cally do the same thing.  I looked at many  of them, but did not find  one
  26.    that operated exactly the way I wanted it to.  So, I wrote my own.  Listed
  27.    below are some of the things that I think make PLANT unique.
  28.  
  29.      1. It will operate in DOS or Windows.
  30.      2. It doesn't mess with Windows' *.ini files.
  31.      3. It can swap screen savers.
  32.      4. It stores unused BMPs, SCRs, and WAVs in compressed archives.
  33.      5. It uses PKZIP, a proven fast and reliable compression utility.
  34.      6. It is easily setup with a simple configuration file.
  35.      7. It supports sequential and random swapping.
  36.      8. It is a small and efficient executable.
  37.      9. It is FREEWARE.
  38.  
  39.    Although PLANT is  a relatively simple  little program that  I'm sure  any
  40.    halfway decent programmer could write, I  would like to publicly thank  my
  41.    lone beta-tester, Dewayne McNair.  It's always helpful to have someone not
  42.    involved in the program writing to do the testing.  Thanks, Dewayne.
  43.  
  44.  
  45.  
  46.    Requirements
  47.    ============
  48.    PLANT should work  with any version  of Windows that  uses BMPs, SCRs,  or
  49.    WAVs.
  50.  
  51.    PKZIP and PKUNZIP  from PKWARE,  Inc are also  required.   PLANT has  been
  52.    tested only with version 2.04g, but should work with other versions  with-
  53.    out problems.  The entire PKZIP package can be found on many BBS's and In-
  54.    ternet file archive sites, or you can contact PKWARE directly:
  55.               PKWARE, Inc
  56.               9025 N. Deerwood Drive
  57.               Brown Deer, WI 53223
  58.  
  59.    Windows is a trademark  of Microsoft Corporation.   PKZIP and PKUNZIP  are
  60.    trademarks of PKWARE Inc.
  61.  
  62.  
  63.  
  64.    Setup
  65.    =====
  66.    1. Place PLANT.EXE and PLANT.CFG together into any directory on your path.
  67.       If you wish to  execute PLANT from Windows,  create a new program  item
  68.       for it.  Change the properties to use PLANT.PIF as the command line and
  69.       PLANT.ICO as the icon.  Also, you will probably wish to check the  'Run
  70.       Minimized' box to allow PLANT to run as an icon.
  71.  
  72.    2. Manually compress (zip) your wallpaper, screen savers, and sound  files
  73.       into separate archives.  These archives can have any name you wish and
  74.       can be placed anywhere in  your file system that  you wish.  Note  that
  75.       PLANT supports individual sound archives for each of the different sys-
  76.       tem sounds.  You could  have an archive of  WAVs just for BEEP  sounds,
  77.       another for STOP  sounds, one  for EXIT sounds,  and so  on.   However,
  78.       PLANT also allows any and  all of the system  sounds to share the  same
  79.       archive.  For  example, in my  system, I have  one archive  made up  of
  80.       longer WAVs that I use just for the START sound.  I have one other  ar-
  81.       chive made up  of shorter  WAVs that  I use  for all  the other  system
  82.       sounds.
  83.  
  84.    3. Edit PLANT.CFG to define the location of various things on your system,
  85.       and to set the planting options.   I have provided a sample  configura-
  86.       tion file with clear (I hope) documentation.
  87.  
  88.    4. Execute PLANT once to produce the  standard-named BMP, SCR, and/or  WAV
  89.       files.  During this  initial execution, you  will probably get  several
  90.       `File Not  Found' messages.   Don't  be alarmed,  this is  normal,  but
  91.       should occur only during the first execution of PLANT (or after a  con-
  92.       figuration change has  been made).   If you get  these messages  during
  93.       subsequent executions, you probably have something defined  incorrectly
  94.       in PLANT.CFG.
  95.  
  96.    5. From Windows Control  Panel select these  standard-named files as  your
  97.       wallpaper, screen saver, and/or system sounds.
  98.  
  99.  
  100.  
  101.    Usage
  102.    =====
  103.    Execute PLANT anytime you wish  to swap BMPs, SCRs,  and WAVs.  You  could
  104.    execute PLANT from your AUTOEXEC.BAT file if you want the swapping to  oc-
  105.    cur at bootup.  Or, you may wish to  create a batch file to execute PLANT
  106.    each time you start windows.  If  you create a batch file called  WIN.BAT,
  107.    then you may need to rename  your \WINDOWS\WIN.COM file to something like
  108.    \WINDOWS\WINSTART.COM to allow the  batch file to  execute instead of the
  109.    com file.
  110.  
  111.    Also, if you wish to suppress  all those PKZip messages from appearing  on
  112.    the screen, you can redirect PLANT's standard output to the NUL device.
  113.  
  114.    For example, here is how a simple WIN.BAT might look:
  115.         @echo off
  116.         plant > nul
  117.         winstart
  118.  
  119.    Another acceptable method for using PLANT is to create a program item  for
  120.    it using PLANT.PIF  and PLANT.ICO  and place  it in  your STARTUP  program
  121.    group.
  122.  
  123.  
  124.  
  125.    Copyright Notice
  126.    ================
  127.    PLANT is Copyright (c) 1993 by Terry Matula.  No part of PLANT may be cop-
  128.    ied in part or in whole, except  as provided in the License Agreement  be-
  129.    low.
  130.  
  131.  
  132.  
  133.    License Agreement
  134.    =================
  135.    PLANT is distributed as FREEWARE.   This means that the  copyright holder
  136.    reserves all rights except the following three which are granted to you at
  137.    no charge.
  138.  
  139.      1. You may use PLANT in its unaltered form.
  140.      2. You may make as many unaltered copies of PLANT as you wish.
  141.      3. You may distribute unaltered copies of PLANT.
  142.  
  143.    You are specifically  prohibited from editing,  modifying, or  in any  way
  144.    changing PLANT.  (PLANT refers to both the executable, PLANT.EXE, and  the
  145.    documentation, PLANT.DOC.)   You  are  also specifically  prohibited  from
  146.    charging, or requesting donations, for any copies that you may distribute.
  147.    Exceptions are for BBS's and commercial on-line systems that charge a mem-
  148.    bership or time charge, and other distribution schemes that charge a fixed
  149.    fee for  distribution media  and/or  shipping.   As  long as  no  specific
  150.    charges are made for this program, this is allowed.
  151.  
  152.    By using, copying, or distributing PLANT,  you are indicating your  agree-
  153.    ment to the above terms.   If you do not agree  with the above terms,  you
  154.    should delete PLANT immediately.
  155.  
  156.  
  157.  
  158.    Registration
  159.    ============
  160.    Because PLANT is FREEWARE, no registration is required.  However, I  would
  161.    appreciate hearing from you anyway.  If you have any comments, ideas, sug-
  162.    gestions, or bug reports, then please  contact me.  I'm more than  willing
  163.    to make any improvements or to add any features that you suggest, as  long
  164.    as they are feasible.   Even if you  really have nothing  to say, I  would
  165.    still like to receive a little note from anyone who uses PLANT.
  166.  
  167.         Terry Matula
  168.         21-G Aiken Village
  169.         Starkville, MS  39759
  170.         e-mail address:  matula@ee.msstate.edu
  171.  
  172.  
  173.  
  174.    WARRANTY and DISCLAIMER
  175.    =======================
  176.    Because the program is  distributed free of charge,  there is no  warranty
  177.    for the program.  The copyright holder provides the program "as is"  with-
  178.    out warranty of any kind, either expressed or implied, including, but  not
  179.    limited to, the implied  warranties of merchantability  and fitness for  a
  180.    particular purpose.  The entire risk as to the quality and performance  of
  181.    the program is with you.   Should the program prove defective, you  assume
  182.    the cost of all necessary servicing, repair or correction.
  183.  
  184.    In no event will the copyright holder be liable for damages, including any
  185.    general, special, incidental or consequential  damages arising out of  the
  186.    use or inability to use the program.   These damages include, but are not
  187.    limited to loss of  data or information,  data being rendered  inaccurate,
  188.    loss of profits, business  interruption, other pecuniary losses  sustained
  189.    by you or third parties, or a failure  of the program to operate with  any
  190.    other programs.
  191.  
  192.